home *** CD-ROM | disk | FTP | other *** search
/ iBrowse Update Disc / iBrowse Update Disc.iso / distrib / man / Manuals / JavaReadMe < prev    next >
Text File  |  1998-02-26  |  5KB  |  129 lines
  1. Java Applet plugin for RISC OS                                  0.72 (16-Feb-97)
  2. ==============================
  3.  
  4. This is the Java Applet Environment (JAE) 1.0.2 plugin for RISC OS browsers.
  5. It will run the vast majority of Java applets currently found on the web.
  6.  
  7. Requirements
  8. ============
  9. You will require a minimum of 8M RAM, and a RISC OS 3.5 or greater machine. A
  10. StrongARM is recommended for more complicated applets.
  11.  
  12. Sound support is only provided on machines with 16bit sound hardware (this
  13. includes all STBs, NCs, A7000s, and newer RiscPCs).
  14.  
  15. Memory usage
  16. ============
  17. The Java heap is statically allocated at startup - it cannot be changed when
  18. running. The size can be controlled by setting the system variable
  19. <Java$MaxHeap> (as done in !Java.SetVars). The following examples are
  20. reasonable for various memory sized machines:
  21.  
  22.         Total memory            <Java$MaxHeap>
  23.         8M                      2500K
  24.         16M                     5M
  25.         32M                     10M
  26.         64M                     20M
  27.  
  28. The larger the maxheap, the more applets you will be able to run. Large
  29. applets, such as JQuake or Corel Office require a max heap of somewhere
  30. around 20M.
  31.  
  32. Memory display
  33. ==============
  34. The 'Memory usage...' iconbar menu option allows you to view the amount
  35. of free space in your Java heap. A 'Garbage collect' button is provided to
  36. give a hint to the virtual machine that you would like to free up some
  37. heap space - if this doesn't work at first, it does not necessarily mean
  38. that free space cannot be recovered.
  39.  
  40. Speed of the desktop
  41. ====================
  42. When the Java virtual machine is under a high load, the machine can slow down
  43. more than desired. The system variable <Java$PollDelay> can be set to control
  44. the maximum delay (in milli-seconds) between wimp polls - the higher the
  45. value, the more time the virtual machine has to execute, but the less
  46. responsive the desktop will be. The lower the value, the less time the
  47. virtual machine has, but the desktop will appear quicker. A setting of around
  48. 200 is a reasonable compromise.
  49.  
  50. The Priority option from the iconbar menu allows you to change these settings
  51. while Java is running.
  52.  
  53. Console
  54. =======
  55. A console option has been added to the Java iconbar menu. Any errors or
  56. textual output which occurs before you have opened the console do not get shown.
  57.  
  58. The Java console displays all text that an applet outputs to System.out
  59. and System.err, including any backtraces from an exception. It is often
  60. useful for debugging applets, or to discover if an applet cannot run due
  61. to running out of memory, etc.
  62.  
  63. Just-In-Time Compiler (JIT)
  64. ===========================
  65. This release contains a beta of Acorn's JIT. This currently gives around a
  66. four-times speed increase on benchmark applets. By default, it is disabled
  67. in the file !Java.!SetVars, since it is not yet fully stable. To enable it,
  68. set the system variable <Java$JIT> On.
  69.  
  70. Proxy
  71. =====
  72. The Java proxy is set independantly of the proxies set by the browser. It is
  73. configured in the file !Java.lib.plugin.properties.
  74.  
  75. If you are running !WebServe, the following settings should work:
  76.         # Proxies
  77.         proxySet=true
  78.         proxyHost=localhost
  79.         proxyPort=80
  80.  
  81. To disable all proxying, and to fetch all classes directly, only the proxySet
  82. line need be set to 'false'.
  83.  
  84. Timeout
  85. =======
  86. The system variable <Java$Timeout> set in !Java.!SetVars allows you to specify,
  87. in seconds, the time before Java automatically quits, assuming it is not
  88. displaying any applets. A value of zero means never timeout.
  89.  
  90. Bootup Thread
  91. =============
  92. The parameter 'bootClass' in the !Java.lib.plugin.properties file allows you
  93. to specify a class which is run when the plugin starts. The specified class
  94. will have full access to the JVM - it will not go via any security
  95. manager. It must lie in the given classpath and must implement
  96. java.lang.Runnable.
  97.  
  98. Some applet sites
  99. =================
  100. The following sites contain collections of applets, and are probably worth
  101. visiting:
  102.         http://www.javasoft.com/        The home of JavaSoft
  103.         http://www.gamelan.com/         Probably the biggest Java collection
  104.         http://www.javaboutique.com/    A smaller, but nicer, collection
  105.  
  106. There are a few links to Java enabled sites on:
  107.         http://www.acorn.co.uk/browser/links.html
  108.  
  109. Problems
  110. ========
  111. If no applets appear, please try the following before requesting help:
  112.  
  113.   o Ensure that if you are using a proxy, you have set the details correctly
  114.     in the !Java.lib.plugin.properties file. (See above)
  115.  
  116.   o Set the system variables <Java$Err> and <Java$Out> to (for example):
  117.         Set Java$Err adfs::4.$.stderr
  118.         Set Java$Out adfs::4.$.stdout
  119.     Then re-run Java, and after about 10 seconds, quit it. The output should
  120.     help locate the problem. If the files are empty, re-run !Java and wait
  121.     longer.
  122.  
  123. Feedback
  124. ========
  125. Please report bugs to us via the following URL:
  126.         http://www.acorn.com/browser/bugform.html
  127.  
  128. These will then be entered directly into our faults database.
  129.